package com.z.system.service;

import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.UUID;

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import com.z.system.dto.RoleDTO;
import com.z.system.model.Role;

/**
 * 角色服务接口
 */
public interface RoleService {

    /**
     * 根据ID获取角色
     */
    Role getRoleById(UUID id);

    /**
     * 根据角色名称获取角色
     */
    Role getRoleByName(String name);

    /**
     * 根据角色标识获取角色
     */
    Role getRoleByCode(String code);

    /**
     * 分页获取角色列表
     */
    Page<Role> getRoles(Pageable pageable, Map<String, Object> params);

    /**
     * 直接从数据库查询获取角色DTO列表（分页），支持搜索参数
     * 避免额外的实体到DTO的转换操作
     */
    Page<RoleDTO> getRoleDTOs(Pageable pageable, Map<String, Object> params);

    /**
     * 获取所有角色
     */
    List<Role> getAllRoles();

    /**
     * 保存角色
     */
    Role saveRole(Role role);

    /**
     * 更新角色
     */
    Role updateRole(Role role);

    /**
     * 删除角色
     */
    void deleteRole(UUID id);

    /**
     * 批量删除角色
     */
    void deleteRoles(Set<UUID> ids);

    /**
     * 分配角色权限
     */
    void assignPermissions(UUID roleId, Set<String> permissionIds);

    /**
     * 获取角色权限ID集合
     */
    Set<UUID> getRolePermissionIds(UUID roleId);
}